home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 376-400 / disk_383 / pcopy / pcopy.doc < prev    next >
Text File  |  1992-05-06  |  13KB  |  317 lines
  1.                               PCOPY
  2.  
  3.         Pcopy was made to produce large amounts of different copies in
  4.         busy environs.  Like:  People are talking to you and you are
  5.         searching programs for them in databases.  Others want
  6.         information how to install some driver.  You divert people to
  7.         others you know to be an authority on their problems.  You are
  8.         copying PD and you have an arrears of two hours.  People ask
  9.         whether their disks are ready yet.
  10.         What are you copying at the moment?  What have you already
  11.         done?  When to insert the next set?
  12.  
  13.         Pcopy shows the actual situation conveniently arranged, starts
  14.         upon disk insertion, and produces reliable copies, because it
  15.         can verify the written data.
  16.  
  17.         Pcopy does not copy copy-protected disks.  At least not that I
  18.         know.  Its working is similar to that of Trackdisk (The software
  19.         that normally controls the drives).  If Trackdisk cannot read a
  20.         disk, than Pcopy probably will not be able too.
  21.  
  22.         If your source disk is failing, you can let Pcopy try to produce
  23.         a copy with the original data recovered.
  24.  
  25.         Although Pcopy displays a lot of information, I think it is a
  26.         rather dangerous copier (on behalf of its autostart
  27.         capabilities) and its application lies in the production area.
  28.  
  29.  
  30.                               START
  31.  
  32.         Pcopy can be executed from either the CLI or the Workbench.
  33.         Two Trackdisk-drives must be available.  That is, ie., the
  34.         internal and a normal external drive.  Selection is done by
  35.         clicking on/off gadgets in a window.  When ready, one can
  36.         proceed by clicking "DONE". If more than two (or less than
  37.         two!) drives are selected, then clicking "DONE" has no effect.
  38.         It is also possible to give the drivenames on the commandline.
  39.         Pcopy will check for drive presence and type.  If the selected
  40.         drives are available, DOS is asked to stay away from them.
  41.         Pcopy takes control of the drives (as does diskcopy) and sets
  42.         up the user interface.  
  43.  
  44.  
  45.                              WINDOWS
  46.  
  47.         There are two small windows (marked "Now in DFx:") which show
  48.         at any moment the drive's contents.  An empty window means an
  49.         empty drive.  Normally the disknames appear in these windows.
  50.         If the disk cannot produce a name, a classification is
  51.         displayed.  All text different from <VolumeName> is printed in
  52.         another color. (black)
  53.  
  54.         In the window "Copy history" appear the names of all
  55.         successfully copied disks.  If you want a name to disappear,
  56.         double click on it.
  57.  
  58.         In the progression window the progress of the copy process is
  59.         graphical presented.  Although the depth gadgets are invisible
  60.         during the copy, they still exist and work.  The graph shows
  61.         first where pcopy HAS written.  Another color displays verify.
  62.         If the same track is to be written more than once, the color
  63.         will change again.  The number tells where Pcopy has written
  64.         last.
  65.  
  66.         Then there is the control panel with the gadgets in it.
  67.  
  68.  
  69.                              GADGETS
  70.  
  71.  
  72.         -- Verify  ON/OFF
  73.  
  74.         The destination disk is read back and compared with the write
  75.         buffer.  It can be turned on and off during the copy process.
  76.  
  77.  
  78.         -- DFx: --> DFy:
  79.  
  80.         Defines which drive is source and which is destination.
  81.         Clicking the arrow reverses the direction.
  82.  
  83.  
  84.         -- Adapt Date
  85.  
  86.         DOS can distinguish the copy from the original if the creation
  87.         and last altered date and time are different on both disks.
  88.         If there are two disks present with the same volumename and
  89.         date/time, DOS will crash.  To prevent this, the standard
  90.         Diskcopy changes these fields.  Also if the BMFLAG is -1, it
  91.         changes it to +1. Pcopy can do this too, thus preventing to
  92.         create an exact copy.  Also if some read error could not be
  93.         repaired, Pcopy can set this flag to zero.  This all happens
  94.         with this gadget set to "ON".  Set to "OFF", the copy will be
  95.         exact (if possible).
  96.  
  97.  
  98.         -- Start Copy
  99.  
  100.         To be used to start the copy process manually.  The command is
  101.         hold until it is possible to start the copy process (two disks
  102.         inserted). A second click before the process is started will
  103.         nullify the start command.  This gadget changes into a
  104.         "Stop Copy" gadget during copying.  A confirmation is required.
  105.         Disk removal, source as well as destination, is treated as a
  106.         confirmed "Stop Copy".
  107.  
  108.  
  109.         -- Auto Start Condition
  110.  
  111.         This whole area is a gadget.  Click in it to cycle the four
  112.         stages.  See auto start for details.
  113.  
  114.  
  115.         -- Triangle gadget
  116.  
  117.         In the topborder there is a gadget with a triangle.  This
  118.         gadget affects the way Pcopy behaves to other disk users.  Its
  119.         usage of the drive hardware it so intensive, that normally
  120.         (triangle pointing up) other users do not get access to their
  121.         drives.  You can let Pcopy be a little more modest by letting
  122.         this gadget point down.  This costs from 3 to 70 seconds or
  123.         more copy time.
  124.  
  125.  
  126.                            AUTO START
  127.  
  128.         When a disk is inserted, it is classified.  To do so, the root
  129.         track is read and analyzed.  If an error is detected while
  130.         reading this track, Pcopy tries to repair the track to make
  131.         this classification safe.  Four different types are
  132.         distinguished and its classification appears in the "Now in .."
  133.         window:
  134.  
  135.  
  136.         -- New, Unformatted
  137.  
  138.         No data is detected.
  139.  
  140.  
  141.         -- Non DOS
  142.  
  143.         Some data is found. But its format is unknown by Pcopy.
  144.  
  145.  
  146.         -- DOS, no root
  147.  
  148.         The track can be read, but the root sector was not found.
  149.  
  150.  
  151.         -- <VolumeName>
  152.  
  153.         The root is found and the name of the disk is displayed.
  154.  
  155.  
  156.         Now that Pcopy knows what kind of disk its dealing with, it can
  157.         let the copy start depending on a user selected condition.
  158.         These are listed:  
  159.  
  160.  
  161.         -- Off: Manual Start
  162.  
  163.         Pcopy does not start copy until the Start gadget is clicked.
  164.  
  165.  
  166.         -- Dest must be New
  167.  
  168.         Pcopy starts only when a disk is classified as "New, Unformatted".
  169.         The formats that are known to be detected are MS-DOS, MSX,
  170.         Archimedes, Atari and Mac.  Probably most other formats are
  171.         detected too, but you must check it for yourself.
  172.  
  173.         -- Dest may not be DOS
  174.  
  175.         Pcopy starts only when a disk is classified as "New, Unformatted"
  176.         OR "Non DOS". By other systems already formatted disks are
  177.         overwritten.
  178.  
  179.         -- Unconditional Start
  180.  
  181.         Starts always upon insertion.  If the disk is not write
  182.         protected, it is simply overwritten.  This is a dangerous
  183.         selection and is emphasized by changing the gadget's color.
  184.         If an Amiga-DOS disk is to be overwritten, some sound is heard
  185.         and a three second delay will elapse before the copy process
  186.         starts.  When you remove the disk within this delay or click
  187.         the "Stop Copy" gadget, no writing has taken place.  You can
  188.         look at the Progression window, and if no graph or number is
  189.         visible, you were in time.  I can only say:  Do not use this
  190.         selection.
  191.  
  192.  
  193.                             REQUESTERS
  194.  
  195.         If an error is detected, a requester will appear.  If abort is
  196.         chosen, then the copy process will be terminated.  The actions
  197.         following upon retry are listed below:
  198.  
  199.            Source read error # xx
  200.            On cylinder # yy, head z.
  201.            <Short error description>
  202.  
  203.         Retry tries to read again.
  204.         Salve tries to repair the faulting track by multiple reads and
  205.         analysis.  Copy continues after this action.
  206.  
  207.            Destination write error # xx
  208.            On cylinder # yy, head z.
  209.            <Short error description>
  210.  
  211.         Retry tries to write again.
  212.  
  213.            Verify error # xx
  214.            On cylinder # yy, head z.
  215.  
  216.         Retry rewrites the track and checks again.
  217.  
  218.         If you do not know what the errors mean, ignore them.  Do a few
  219.         retries and abort if no success.
  220.  
  221.         Some actions produce confirmation requesters, like Stop Copy and
  222.         the standard stop gadget.  These are straightforward.  But
  223.         perhaps the system is too low on memory to honor the memory
  224.         requests to build the requester.  Then some defaults become
  225.         active:  "Abort" and "User was serious".
  226.  
  227.         The requester is not a true requester but a window with gadgets.
  228.         So if you use DMouse in a certain way, you have to place the
  229.         mouse pointer in this requester to use the standard keyboard
  230.         shortcuts.
  231.  
  232.  
  233.                            TRACK SALVAGE
  234.  
  235.         Pcopy has capabilities to recover data from a damaged track.  The
  236.         history window changes into a report window.  Each salved track
  237.         produces two lines.  The line starting with 'L' reports the not
  238.         recovered labels.  The 'S' reports not recovered sectors.  Behind
  239.         the 'S' and 'L' the tracknumber is displayed.  If the line
  240.         remains empty, you are lucky.  Otherwise the numbers of the not
  241.         recovered labels or sectors will appear.  Normally labels are not
  242.         used, and diskcopy does not copy them at all.  So ignore the
  243.         label report.  The not recovered sectors are more important.  A
  244.         disk that has been completely copied, but with one or more not
  245.         recovered sectors, appears Italic in the history window.  The
  246.         report remains visible as long as the destination disk stays in
  247.         the drive.  A special Pcopy pattern ('Pcopy2',X,0) is written
  248.         into not recovered sectors.  In that case if "Adapt Date" is ON,
  249.         the BMFLAG is made 0.
  250.  
  251.  
  252.                            PERFORMANCE
  253.  
  254.         Pcopy is fast.  The best times:  100/68 seconds, verify ON/OFF.
  255.  
  256.         Pcopy tries to be friendly to other tasks, it leaves them a lot
  257.         of time.  But in its disk use it is truly unfriendly.
  258.         Therefore you can tell Pcopy to give way to other tasks which
  259.         want to use the disk hardware (other drives than those
  260.         controlled by (this) Pcopy, of course).
  261.  
  262.         It is recommended to install TrackSalve when Pcopy is used on a
  263.         system with more than two drives.  In the Trackdisk.device is a
  264.         nasty bug which can interfere with Pcopy.  Nevertheless pcopy
  265.         will deliver good copies.
  266.  
  267.  
  268.  
  269.                             HISTORY
  270.  
  271.         Pcopy 2.0 is a rewrite of Pcopy 1.0.(Fish 151).  The copier
  272.         mostly in assembly and the user interface in C.  The user
  273.         interface became a separate task.  Pcopy uses ONLY code and data
  274.         derived from the original .i and .h files.  Therefore I think it
  275.         will be compatible with future releases of the OS.
  276.  
  277.         Pcopy 2.01.  The audio.device is not to be accessed in the
  278.         standard way, as I read recently in a publication of Commodore.
  279.         Pcopy used the standard method and sometimes the audio.device
  280.         died.  Pcopy waited for an answer.. forever...
  281.         The algorithms of the size of the requester and its gadgets used
  282.         the default font instead of the font of the screen on which
  283.         Pcopy executes.  The requesters now are perhaps a little nicer
  284.         when other fonts are used.
  285.         The salve routine has been made a little more efficient without
  286.         changing its functionality.  This results into a quicker login
  287.         of non-Dos disks and a slightly shorter track salvage.
  288.  
  289.     Pcopy 2.02.  The progression graph now reflects write, verify and
  290.     rewrite.
  291.  
  292.         Pcopy 2.1.  Better salve routines.  The routines in TrackSalve
  293.         are far superior to the old ones in Pcopy.  These routine are
  294.         now replaced.
  295.  
  296.         Pcopy 2.11. If just a sync was found, Pcopy classified the disk as
  297.         "Amiga format, no root" instead of "No Amiga format".
  298.  
  299.  
  300.                             COPYRIGHT
  301.  
  302.         Copyright 1989 by D.W.Reisig.  Pcopy is freely distributable
  303.         (FreeWare).  All you may charge for is medium costs.  You must
  304.         include this file (Pcopy.doc) with the program (Pcopy). You
  305.         may not change these files.  
  306.  
  307.  
  308.         I like to receive mail, so if you have any suggestions or
  309.         remarks:
  310.  
  311.         Dirk Reisig
  312.         Woudweeren 10
  313.         1151 AV  Broek in Waterland
  314.         Holland
  315.  
  316.         23-Aug-90
  317.